← Tilbage til Hovedside

Overblik

Dette afsnit beskriver de tilgængelige REST-endpoints til opslag af køretøjer i tinglysningssystemet.

Et opslag kan foretages ved hjælp af en unik uuid. Svarformatet kan styres via valgfrie query parametre, der understøtter OIO XML, XHTML og TMV XHTML formater.

Svaret er et XML dokument af typen BilSummariskHentResultat, der indeholder en fuld rettighedsoversigt for det angivne køretøj.

Endpoints

OpslagUUID

Endpoint URL: bil/uuid/{uuid}

Method

GET

Beskrivelse

Hent de fulde summariske oplysninger for et køretøj ved hjælp af dets UUID. Svarformatet kan styres via valgfrie query parametre.

Input

Path parameter:

  • uuid

Valgfrie query parametre:

  • xhtml=true - returnerer svaret som XHTML

  • tmvXhtml=true - returnerer svaret som TMV XHTML

  • Hvis ingen angives, returneres svaret som OIO XML (standard)

Output

XML dokument af typen BilSummariskHentResultat (OIO XML, XHTML eller TMV XHTML afhængigt af parametre).

Formateringen af XHTML- og TMV XHTML-svar er ikke dokumenteret i detaljer og kan ændres uden varsel.

Fejlhåndtering

Standard HTTP fejlkoder ved ugyldigt input eller manglende adgang.

Interaktionsmønster

Forespørgsel-svar

Eksempel på forespørgsel:

GET /bil/uuid/34879c09-85a9-401c-becd-5b753536dda5?xhtml=false&tmvxhtml=false HTTP/1.1
host: nc-dev-xml-api.tinglysning.dk
accept: */*

SoegBil

Endpoint URL: soegbil

Method

GET

Beskrivelse

Søgning efter køretøjer ved hjælp af forskellige kriterier. Kun én søgetype kan bruges pr. forespørgsel: stelnummer (stelnr), CVR-nummer (cvr) eller navn med fødselsdato (navn + fdato).

Input

Query parametre (gensidigt udelukkende):

  • stelnr - Stelnummer (implicit wildcard * præfiks anvendes)

  • cvr - Virksomhedsregistreringsnummer

  • navn + fdato - Navn og fødselsdato (begge krævet sammen)

Output

JSON-svar indeholdende en liste af matchende køretøjer med grundlæggende oplysninger (inkl. uuid).

Fejlhåndtering

  • Standard HTTP fejlkoder ved ugyldigt input eller manglende adgang

Interaktionsmønster

Forespørgsel-svar

Eksempel på forespørgsel:

GET /soegbil/99e5272d-396b-4e38-b033-5ea9098f456a?stelnr=WF0SXXWPGSFK29190&cvr=&navn=John%20Doe&fdato=01.01.1970 HTTP/1.1